home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / util1 / logit21.zip / LOGIT21.TXT < prev    next >
Text File  |  1993-03-22  |  7KB  |  186 lines
  1.  
  2.                                    LOGit
  3.                             Date & Time Utility
  4.                                      
  5.                             Version 2.1 3-19-93
  6.                      (c) 1992, 1993 DYNAMOUS Software.
  7.                            All Rights Reserved.
  8.                               47 Kristin Dr.
  9.                             Rochester, NY 14624
  10.  
  11. Concept:
  12.  
  13. ■ Have you ever wondered if someone turned on your PC while you were not
  14.   there?
  15. ■ Is it hard to remember when you did that last backup of your hard disk?
  16. ■ Do you know what other people do when they use your PC?
  17. ■ Would you like to know if someone was looking at your personal
  18.   information or financial data?
  19. ■ What games do the kids play when you're not around and how long do they
  20.   play them?
  21.  
  22. If you'd like to know the answers to these questions you can install LOGit
  23. on your PC to record the date and time these events occur.
  24.  
  25. Introduction:
  26.  
  27. LOGit is a useful utility that keeps a record of when events occur.  You
  28. can add LOGit to a batch file or to the AUTOEXEC.BAT file.
  29.  
  30. When you add LOGit to a batch file, LOGit will keep a record of:
  31.  
  32. ■ when a program was last used.
  33. ■ conditions that occurred during the batch file execution.
  34.  
  35. When you add LOGit to the AUTOEXEC.BAT, LOGit will keep a record of when
  36.   the PC was booted.
  37.  
  38. Usage:
  39.  
  40. You can use LOGit by executing the program by its name:
  41.  
  42.      C:\> LOGit
  43.  
  44. LOGit will display the program information and then write a small
  45. informational file containing:
  46.  
  47.        LOGit was executed at: 21:47:31 on 3/09/93
  48.  
  49. Option Usage:
  50.  
  51. The following options may be used on the command line to change the
  52. defaults of LOGit.  This will allow you to use LOGit for your specific
  53. needs.
  54.  
  55.      C:\> LOGit /f:[d:\]filename.ext /t:"Text comment" /m:o /l:lines
  56.  
  57. Where:
  58.  
  59. /f:[d:\]filename.ext The name of the log file that LOGit will write.
  60.                [d:\] can be used to specify another drive or directory.
  61.                Example - /f:c:\logs\database.log
  62.                Default - logit.log in the current directory.
  63.      
  64. /t:"Text comment" The text comment to be written in the log file.
  65.                If the text contains spaces, you must enclose the text in
  66.                double (") quotes.
  67.                Example - /t:"The Database was last packed on:"
  68.                Default - LOGit was executed at:
  69.      
  70. /m:o           Use 'o' for the overwrite mode.
  71.                The log file will contain only one entry, which will be the
  72.                last time LOGit was executed.
  73.                Default - No switch will append the new entry to file.
  74.      
  75. /l:lines       Use 1 through 99.*
  76.                This limits the number of lines LOGit will maintain in the
  77.                log file.
  78.                Example - /l:25 {The number of lines in the log file will
  79.                not exceed 25 lines.}
  80.                Default - The number of lines in the log file will be
  81.                unlimited.
  82.  
  83. Note: Item marked with the '*' are only availible after registering LOGit
  84. with DYNAMOUS Software.  You will also receive a configuration program to
  85. store your default configuration and enable the registered options.
  86.  
  87. Example Using Options:
  88.  
  89. If LOGit is in your PATH you can execute the program from any directory.
  90. If it is not in your PATH you must change to the directory on your hard
  91. disk where you keep LOGit .  For more information concerning your PATH or
  92. the TYPE command, refer to your DOS manual.
  93.  
  94. At the DOS prompt type:
  95.  
  96.      C:\UTIL\> LOGit /f:c:\bbs.log /t:"Node 1 was started at:"
  97.  
  98. After the example executes, use the DOS "TYPE" command to view the log
  99. file:
  100.  
  101.      C:\UTIL\> TYPE c:\bbs.log
  102.  
  103. DOS will display the contents of the log file.
  104.  
  105.      Node 1 was started at: 17:39:23 on 2/19/93
  106.  
  107. Error Levels:
  108.  
  109. LOGit will return an error level after it executes.  The following list
  110. shows the error levels and their meanings.
  111.  
  112. Errorlevel 0 -- The error level is set to 0 if the program executed
  113.   successfully.
  114. Errorlevel 1 -- The error level is set to 1 if the user enters an invalid
  115.   option or /? /H help requested.
  116. Errorlevel 2 -- The error level is set to 2 if an error occurs opening or
  117.   writing to the log file.*
  118. Errorlevel 3 -- The error level is set to 3 if the program cannot find
  119. enough memory.*
  120. Errorlevel 4 -- The error level is set to 4 if the requested log file name
  121. is not a valid DOS file name.*
  122.  
  123. * NOTE: LOGit will display an error message when these conditions occur.
  124.  
  125. Sample Batch File:
  126.  
  127. This batch file shows the usefulness of LOGit, the use of the options and
  128. the use of error levels.
  129.  
  130.      @echo off
  131.      c:\util\tape.exe /full
  132.      if not errrorlevel 0 goto ABORT
  133.      c:\util\LOGit /f:c:\logs\backup.log /m:o /t:"Last backup was completed
  134.      successfully on:"
  135.      if not errrorlevel 0 goto BADLOG
  136.      goto END
  137.      :ABORT
  138.      c:\LOGit /f:backup.log /t:"An Error occurred during the last backup
  139.      on:"
  140.      if not errrorlevel 0 goto BADLOG
  141.      goto END
  142.      :BADLOG
  143.      echo Unable to create or write to log file. Check usage or disk space.
  144.      pause
  145.      :END
  146.  
  147. This BATCH file will execute a backup program called TAPE.  When the backup
  148. finishes successfully LOGIT will write a new log file deleting any existing
  149. log file of the same name.  If  LOGit  is successful writing the new log
  150. file, BACKUP.LOG in the directory C:\LOGS, the batch file will end.
  151. BACKUP.LOG will contain:
  152.  
  153.      Last backup was completed successfully on: 21:15 on 03/11/93
  154.  
  155. If  the backup program cannot complete successfully LOGit will add a new
  156. entry to an existing log file of the same name.  BACKUP.LOG will contain:
  157.  
  158.      Last backup was completed successfully at: 21:15 on 03/11/93
  159.      An Error occurred during the last backup at: 20:30 on 03/12/93
  160.  
  161. If LOGit is unable to write the log file for any reason, a message will be
  162. displayed to the screen and the batch file will pause.
  163.  
  164. For more information concerning BATCH files, refer to your DOS manual.
  165. Shareware Notice:
  166.  
  167. You may use this utility for a 30 day trial period.  If you do not register
  168. within the trial period, please discontinue using this software.
  169.  
  170. If you like this utility please consider registering LOGit with DYNAMOUS
  171. Software.  You will receive a registered copy of LOGit and LOGITCFG to
  172. personalize your copy. This enables the 'registered options' and allows you
  173. to change the program defaults.  We also include other shareware utilities
  174. we have written.
  175.  
  176. To register, please send $5 (US) plus $3.50 (US) for media and US mailing
  177. to DYNAMOUS Software.  If you wish to avoid the media and mailing costs,
  178. register with DYNAMOUS and then you may download your registered version
  179. on:
  180.      "The Hat's Place BBS" (716) 594-5572 16.8K USR HST Dual Standard
  181.  
  182. Site licenses discounts are available by contacting DYNAMOUS Software for
  183. more information.
  184.  
  185. DYNAMOUS Software   -    47 Kristin Dr.     Rochester, NY      14624
  186.